2 Tool Setup

This chapter provides a step-by-step recipe for installing and configuring all tools required for building course materials with Quarto, managing content with GitHub, and integrating outputs into Blackboard Ultra.

While GitHub is strongly recommended for version control and long-term course management, users who prefer to work entirely on local machines or cloud-synced drives (Google Drive, OneDrive, Dropbox, iCloud Drive) may skip the repository creation steps and proceed directly to Chapter 3.

However, the GitHub-based workflow—especially when paired with Antigravity or VS Code—is highly preferred for reproducibility, collaboration, and maintaining a clean version history of your teaching materials.

This recipe assumes no prior experience. Each step includes instructions, verification checks, and placeholders for screenshots.

2.1 Install Git

Git is the version control system used throughout the recommended workflow. You can choose the platform from the installation on the Git website.

Figure 2.1: Installing Git - Linux Screenshot Placeholder

Install Git using your operating system:
1. macOS:
```
brew install git
```
1. Windows: Download
2. Linux:
```
sudo apt update && sudo apt install git -y
```
Verify installation:
```
git --version
```

2.2 Install GitHub CLI

GitHub CLI (gh) enables authentication and repository operations directly from the terminal. Download and install from: GitHub CLI

2.3 Create a GitHub Account

A GitHub account stores repositories, manages version history, and integrates directly with Antigravity or VS Code.

Visit GitHub

Create an account

Choose a professional username

2.4 Create Your GitHub Pages Repository

(Optional for users who plan to work only on local/cloud drives)

This step creates your personal website: https://yourusername.github.io

If you prefer to work without GitHub, skip to Chapter 3. However, the GitHub-based workflow is strongly recommended.

Go to https://github.com/new, or click on the + icon in the top-right corner of your GitHub dashboard shown in Figure 2.5.
Set repository name:
1. yourusername.github.io creates your personal website repository
2. For a course repository, use coursenumber-coursename (e.g. AD688-big-data-and-cloud-computing)
```
yourusername.github.io
```
Select Private, since we want this to be available for instructors only.
Add README and .gitignore, you can choose the template to be python or r to avoid syncing the virtual environments to the git repo.
Create repository

2.4.1 Configure Git Identity and SSH Keys

(Required only if using GitHub workflow)

2.4.2 Configure identity

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

2.4.3 Generate an SSH key

ssh-keygen -t ed25519

2.5 Add the public key to GitHub

cat ~/.ssh/id_ed25519.pub

Add it to https://github.com/settings/keys

2.6 Test authentication

ssh -T git@github.com

3 Clone Your GitHub Pages Repository

(Skip this step if not using GitHub)

3.1 Instructions

Clone repository:

git clone git@github.com:yourusername/yourusername.github.io.git
cd yourusername.github.io

Create a sample file:

echo "Welcome to my GitHub Pages site." >> index.md

Stage and commit:

git add .
git commit -m "Initial commit"

Push:

git push origin main

Pull:

git pull

4 Install Quarto

Quarto is the publishing framework used in this book.

4.1 Instructions

Download from: https://quarto.org/docs/download/

Verify:

quarto --version

5 Install Pandoc

Pandoc is required for document format conversion.

5.1 Instructions

macOS:
```
brew install pandoc
```
Linux:
```
sudo apt install pandoc -y
```

Windows installer already includes Pandoc.

6 Install Graphviz

Graphviz supports diagrams and visual structures.

6.1 Instructions

macOS:
```
brew install graphviz
```
Linux:
```
sudo apt install graphviz -y
```
Windows: Download https://graphviz.org/download/

7 Install Python 3.12 or higher

7.1 Instructions

Download from: https://www.python.org/downloads/

Select “Add Python to PATH” during installation.

7.2 Verification

python3 --version

8 Install R and RTools

8.1 Instructions

Install R: https://cran.r-project.org/

Windows users install RTools: https://cran.r-project.org/bin/windows/Rtools/

9 Install Antigravity (or VSCode) IDE

Antigravity is the preferred IDE for this workflow because it integrates:

GitHub
Jupyter
Python
Quarto
Remote development
AI agents
Extension ecosystem

In case you are using local/cloud drive, you can also use any other IDE that you are comfortable with.

9.1 Instructions

Download: https://antigravity.google/

10 Install Required Antigravity Extensions

The following extension groups must be installed for the quarto workflow:

Figure 10.1: VSCode/Antigravity Extensions Installed

11 Create Python and R Environments (Optional)

11.1 Python virtual environment

python3 -m venv .venv

Activate:

macOS/Linux:

source .venv/bin/activate

Windows:

.venv\Scripts\activate

Install packages:

pip install numpy pandas jupyter matplotlib quarto

11.2 R environment using renv

#| eval: false
#| echo: true
install.packages("renv")
renv::init()
install.packages(c("tidyverse", "knitr", "rmarkdown"))
renv::snapshot()

12 Verification Checklist

Check that each core tool is installed:

Lets check for the installed tools on command lines:

git --version
python3 --version
pip --version
jupyter --version
java -version
scala -version
spark-shell --version
poetry --version
quarto check

13 Next Steps

If you chose not to create a GitHub repository, proceed directly to Chapter 3, where you will learn the authoring fundamentals of Markdown, LaTeX, and Quarto.

If you completed the GitHub setup, you now have a fully configured development environment ready for:

Authoring (Chapter 3)
Building Quarto websites (Chapter 4)
Connecting content to Blackboard Ultra (Chapters 5–6)